feat(field): exercise live injection route configurations - #4317

Summary

Continue #4228 from merged #4314 by applying the same canonical multi-edge line-up contract to a live multi-zone water-injection network.

• exercise primary, brownfield and redundant/dual injection paths on one existing FieldNetworkTopology / LoopedPipeNetwork;
• retain live WellFlow injectivity, zone allocation and fracture-pressure checks;
• add WellFlow.ReservoirLayer.setReservoirPressure(...) / getReservoirPressure(...) so lifecycle pressure changes keep the layer boundary and its owning stream synchronized;
• verify process-automation switching, selected-path and dual-path flow, exact route restoration, mass conservation and lower injectivity after a controlled reservoir-pressure increase;
• preserve topology, typed equipment identity and each edge's hydraulic-model selection.

This adds no graph, hydraulic solver, injection-well model, optimizer, evidence store, schedule or cost abstraction.

Engineering behavior

The synthetic acceptance case starts from a 180 bara water source and one two-zone injector. It switches complete two-edge primary and brownfield paths and a four-edge redundant line-up through configuration.injector route.selection. The live well remains the owner of injectivity, allocation and fracture evidence. Reservoir-pressure updates are delegated to each existing WellFlow.ReservoirLayer, which synchronizes its reservoir stream without modifying PI/II, fracture pressure, composition or the field graph.

The evidence is implementation plus synthetic integration, conservation and monotonic lifecycle-trend validation. It is not injectivity, fracture, pump-map, outage, brownfield, field, laboratory or commercial-simulator qualification.

Validation

Exact published commit: f7401f2b36aa0d5fdc7bd2fb9d6e1123de2fabb9
Exact published tree: 611d8ea6c45421840052d734c308f15efc295074
Base/master: d27433c40ba52cd6d647462f3ba388f1a7fc8dce

Passed locally:

• 150 adjacent JUnit tests; 0 failures/errors/skips:
  • FieldWellNetworkProcessUnitTest (6)
  • FieldWellNetworkCouplerTest (10)
  • FieldNetworkScaleAcceptanceTest (3)
  • WellFlowTest (6)
  • OutOfZoneInjectionTest (24)
  • ProcessAutomationTest (101)
• compile;
• Spotless apply/check;
• Checkstyle;
• PMD report generation;
• documentation search (788 Markdown, 1 HTML);
• generated engineering coverage --check (3,376 public types);
• git diff --check.

Local Javadocs remain blocked by the runtime's missing javadoc executable. The local pre-commit executable is absent; mandatory direct gates passed. Exact-head hosted CI is pending and no hosted validation is claimed yet.

Documentation impact

Updated the SURF integration guide and pipeline/network skill with live injection line-ups, synchronized reservoir-layer pressure updates, evidence boundaries and the revised dependency order. Generated engineering coverage was refreshed.

Coordination and stop boundary

• [Campaign] State-of-the-art well, subsea gathering, injection and SURF network modelling/design #4228 owns canonical production/injection topology and this live injection acceptance.
• Field-to-facility production optimization: coupled wells, routing, equipment constraints and operating envelope #4188/[Campaign] Industrial-scale ProcessSystem and ProcessModel optimization #3154 and draft feat(optimization): persist and revalidate field envelope evidence #4312 own optimizer/evidence persistence; this PR only provides the physical action and validation case they can consume.
• [Campaign] Professional reservoir-to-market dynamic process simulation #2911/Close the transient/dynamics parity gap: sustained severe slugging, liquid-rich stability, and a published controls benchmark #3298 retain transient/two-fluid qualification.
• [Campaign] State-of-the-art NeqSim MCP process simulation and troubleshooting #3153 and [Campaign] Professional DEXPI and P&ID workflow #2899/[Campaign] Professional ISO 10628 PFD generation #1332 remain downstream MCP/agent and DEXPI consumers.

Next dependency

Scale the same live production/injection and route-configuration contract to qualified pump/compressor maps, shared host power/capacity constraints and multi-period lifecycle evidence. Independent thermal, ST-F101 and F109 qualification remains separate.

Refs #4228, #4188, #3154, #2911, #3298, #3153, #2899, #1332.